<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
<html lang="en">
<head>
  <meta name="copyright" content=
  "Copyright (c) IBM Corporation and others 2000, 2011. This page is made available under license. For full details see the LEGAL in the documentation book that contains this page.">
  <meta http-equiv="Content-Type" content="text/html; charset=utf-8">
  <meta http-equiv="Content-Style-Type" content="text/css">
  <link rel="STYLESHEET" href="../book.css" charset="ISO-8859-1" type="text/css">
  <title>Project Explorer view</title>
  <script language="JavaScript" src="PLUGINS_ROOT/org.eclipse.help/livehelp.js" type="text/javascript"></script>
</head>
<body bgcolor="#FFFFFF">
  <h1>Project Explorer view</h1>
  <p class="Intro">This view provides a hierarchical view of the artifacts in the Workbench, which is customized by the
  specific configuration of your Workbench.</p>
  <p>From here, you can open files for editing or select resources for operations such as exporting.</p>
  <p class="Para">A typical Project Explorer with only the Java Development Tools (JDT) installed looks similar to the
  Package Explorer:</p>
  <p>Right-click on any resource in the Project Explorer view to open a pop-up menu that allows you to perform
  operations such as copying, moving, creating new resources, comparing resources with each other, or performing team
  operations. To see a description of what each menu item does, move selection highlight to that menu item and press
  the context-sensitive help key (e.g., F1 on Microsoft Windows).</p>
  <p class="Head">By default, the Project Explorer view is included in the Resources perspective. To add the Project
  Explorer view to the current perspective, click <a class="command-link" href=
  'javascript:executeCommand("org.eclipse.ui.views.showView(org.eclipse.ui.views.showView.viewId=org.eclipse.ui.navigator.ProjectExplorer)")'>
  <img src="PLUGINS_ROOT/org.eclipse.help/command_link.svg" alt="command link"> <b>Window &gt; Show View &gt; Other...
  &gt; General &gt; Project Explorer</b></a>.</p>
  <h2>Toolbar</h2>
  <div class="Topic"></div>
  <h3>Collapse All</h3>
  <p>This command collapses the tree expansion state of all resources in the view.</p>
  <h3>Link with Editor</h3>
  <p>This command toggles whether the Project Explorer selection is linked to the active editor. When this option is
  selected, changing the active editor will automatically update the Project Explorer selection to the resource being
  edited.</p>
  <h3>Select and deselect content to filter to the content in the tree</h3>
  <p>This command opens a dialog allowing to configure some filters to enable.</p>
  <h2>View Menus</h2>
  <p>Click the ⋮ vertical ellipsis to open a menu of items specific to the Project Explorer. Some extra menu entries
  can be added by extension and may not be documented here.</p>
  <h3>Project Presentation</h3>
  <p>Select whether the physically nested projects should be shown as root elements (Flat), or should be shown under
  their parent project in place of their corresponding folder (Hierarchical).</p>
  <h3>Top-Level Elements</h3>
  <p>Select whether the top level-elements should be the selected working sets with projects as children, or the
  visible projects.</p>
  <h3>Select Working Set</h3>
  <p>Opens the <b>Select Working Set</b> dialog to allow selecting a working set for the Project Explorer.</p>
  <h3>Deselect Working Set</h3>
  <p>Deselects the current working set.</p>
  <h3>Edit Active Working Set</h3>
  <p>Opens the <b>Edit Working Set</b> dialog to allow changing the current working set.</p>
  <p><br>
  In addition to these menu items, the Project Explorer menu shows a list of recently used working sets that have been
  selected in the view.</p>
  <div class="Topic">
    <h3>Filters and Customization</h3>
    <p class="Para">This command allows you to change the view for your specific needs. You may select pre-defined
    filters to apply to the view so that you can show or hide various artifacts as needed. The default filters
    available with the Java development tools (JDT) is shown below:</p>
    <p class="Para"><img src="../images/Image276_available_filters.png" alt=
    "Available Customizations &gt; Filters dialog" border="0"></p>
    <p class="Para">You can also define your own filters based on the name of a resource. Full name or regular
    expressions are allowed.</p>
    <p class="Para"><img src="../images/Image276_user_filters.png" alt=
    "Available Customizations &gt; User filters dialog" border="0"></p>
    <p class="Para">You may also choose the types of content for the view to show as well. The default content
    extensions available with the Java development tools (JDT) is shown below, but your specific extensions will be
    determined by your workbench configuration:</p>
    <p class="Para"><img src="../images/Image276_available_content.png" alt=
    "Available Customizations &gt; Content dialog" border="0"></p>
  </div>
  <h3>Link with Editor</h3>
  <p>See the toolbar item description above.</p>
  <p><br></p>
  <h2>Context menu</h2>
  <p>The context-menu allows to access some general Project management operations as well as operations that are
  specific to your selection. Some plugins can extend the context-menu with additional entries that might not be
  documented here.</p>
  <div class="Topic">
    <h3 class="Head">New</h3>
    <p class="Para">This command allows you to create a new resource in the Workbench. Select the type of resource to
    create from the submenu.</p>
  </div>
  <div class="Topic">
    <h3 class="Head">Copy</h3>
    <p class="Para">This command copies the selected resource to the clipboard.</p>
  </div>
  <h3>Paste</h3>
  <p>This command pastes resources on the clipboard into the selected project or folder. If a resource is selected the
  resources on the clipboard are pasted as siblings of the selected resource.</p>
  <h3 class="Head">Delete</h3>
  <p class="Para">This command deletes the selected resource from the workspace.</p>
  <div class="Topic">
    <h3 class="Head">Move</h3>
    <p class="Para">This command moves the selected resource to another location. A dialog will appear, prompting for
    the destination location to which the resource will be moved.</p>
  </div>
  <div class="Topic">
    <h3 class="Head">Rename</h3>
    <p class="Para">This command allows you to specify a new name for the selected resource.</p>
  </div>
  <div class="Topic">
    <h3 class="Head">Import</h3>
    <p class="Para">This command opens the import wizard and allows you to select resources to import into the
    Workbench.</p>
  </div>
  <div class="Topic">
    <h3 class="Head">Export</h3>
    <p class="Para">This command opens the export wizard and allows you to export resources to an external
    location.</p>
  </div>
  <h3 class="Head">Refresh</h3>
  <p class="Para">This command refreshes the Workbench's view of the selected resource and its children. For example,
  this is used when you create a new file for an existing project outside the Workbench and want the file to appear in
  the Project Explorer view.</p>
  <div class="Topic">
    <h3 class="Head">Close Project</h3>
    <p class="Para">The close project command is visible when an open project is selected. This command closes the
    selected project.</p>
  </div>
  <div class="Topic">
    <h3 class="Head">Close Unrelated Projects</h3>
    <p class="Para">This command will close any project which are unrelated to the selected project.</p>
  </div>
  <h3>Open Project</h3>
  <p>The open project command is visible when a closed project is selected. This command opens the selected
  project.</p>
  <div class="Topic">
    <h3 class="Head">Team</h3>
    <p class="Head">Menu items in the Team sub-menu are related to version control management and are determined by the
    version control management system that is associated with the project. Eclipse provides the special menu item
    <b>Share Project...</b> for projects that are not under version control management. This command will present a
    wizard that allows you to choose to share the project with any version control management systems that has been
    added to Eclipse.</p>
  </div>
  <div class="Topic">
    <h3 class="Head">Compare With</h3>
    <p class="Para">Commands on the Compare With sub-menu allow you to do one of the following types of compares:</p>
    <ul class="UnorderedList">
      <li class="Item">Compare two or three selected resources with each other</li>
      <li class="Item">Compare the selected resource with remote versions (if the project is associated with a version
      control management system).</li>
      <li class="Item">Compare the selected resource with a local history state</li>
    </ul>
    <p class="Para">After you select the type of compare you want to do, you will either see a compare editor or a
    compare dialog. In the compare editor, you can browse and copy various changes between the compared resources. In
    the compare dialog, you can only browse through the changes.</p>
  </div>
  <div class="Topic">
    <h3 class="Head">Replace With</h3>
    <p class="Para">Commands on the Replace With sub-menu allow you to replace the selected resource with another state
    from the local history. If the project is under version control management, there may be additional items supplied
    by the version control management system as well.</p>
  </div>
  <div class="Topic">
    <h3 class="Head">Properties</h3>
    <p class="Para">This command displays the properties of the selected resource. The kinds of properties that are
    displayed depend on what type of resource is selected. Resource properties may include (but are not limited
    to):</p>
    <ul class="UnorderedList">
      <li class="Item">Path relative to the project in which it is held</li>
      <li class="Item">Type of resource</li>
      <li class="Item">Absolute file system path, or name of path variable when using linked resources</li>
      <li class="Item">Resolved path variable when using a path variable for a linked resource</li>
      <li class="Item">Size of resource</li>
      <li class="Item">Last modified date</li>
      <li class="Item">Read-only status</li>
      <li class="Item">Derived resource status</li>
      <li class="Item">Execution arguments, if it is an executable resource</li>
      <li class="Item">Program launchers, if it is launchable</li>
      <li class="Item">Project dependencies, if any</li>
    </ul>
  </div>
  <h3 class="related">Related concepts</h3><a href="../concepts/cworkset.htm">Working Sets</a><br>
  <a href="../concepts/concepts-29.htm">Three-way compare</a><br>
  <a href="../concepts/concepts-13.htm">Linked resources</a>
  <h3 class="related">Related reference</h3><a href="ref-25.htm">Compare editor</a>
</body>
</html>
